[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 TOKCOUNT() (INTEGER)

 Function
  Access the number of tokens pending.

 Syntax
  TOKCOUNT()   No arguments are required

 Return Type & Value
  INTEGER
  Returns the number of tokens available.

 Remarks
  Parameter passing between PCBoard and PPL applications (and between PPL
  applications) and command line parsing is accomplished via tokens.
  This function will return the number of tokens available via the
  GETTOKEN statement and the GETTOKEN() function.  The value returned by
  this will be decremented after each token is retrieved until it reaches
  0 (no more tokens available).  The TOKENIZE function will overwrite any
  pending tokens with new tokens and reinitialize this function to the
  new number.  Finally, the TOKENSTR() function will clear this function
  to 0 and return all tokens in a string with semi-colons separating
  individual tokens.

 Examples
  PRINTLN "There are ",TOKCOUNT()," tokens"
  WHILE (TOKCOUNT() > 0) PRINTLN GETTOKEN()

See Also:
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson